home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Gold Collection / Software Vault - The Gold Collection (American Databankers) (1993).ISO / cdr35 / gaplok11.zip / GAPLOCK.DOC < prev    next >
Text File  |  1993-05-18  |  6KB  |  161 lines
  1.  ═══════════════════════════════════════════════════════════════════════════
  2.  
  3.                           GAPLOCK Version 1.1
  4.  
  5.                       Multi-Node BBS Event Utility
  6.  
  7.                               Written by:
  8.                               Jerry Liddle
  9.                             119 Edward Drive
  10.                       Swedesboro, New Jersey 08085
  11.  
  12.                              The Beckett BBS
  13.                   (609) 467-3898 USR 14.4 Dual Standard
  14.                   (609) 467-8612 USR 16.8 Dual Standard
  15.                      (609) 467-0515 USR 14.4 V.32bis
  16.  ═══════════════════════════════════════════════════════════════════════════
  17.  
  18.                    Warranty
  19.  
  20.  This product is provided "as is" without warranty of any kind. The entire
  21.  risk as to the results and  performance of the program is assumed by you.
  22.  Futhermore, the  author does  not warrant, guarantee, or  make any  other
  23.  representations regarding  the use of,  or the  results of the use of the
  24.  program,  and you  rely on the  program and  results  solely at  your own
  25.  risk.  The author  cannot and  will not accept  responsibility for system
  26.  damage, loss of profit, or any other special, consequential or incidental 
  27.  damages  resulting  from  the  use  or  inability  to  use this  product.
  28.  
  29. Overview of GAPLOCK
  30. ──────────────────────────────────────────────────────────────────────────
  31.   
  32. Since I run a multi-node BBS, and have events that require all nodes
  33. to be down, I wrote GAPLOCK to keep my other nodes busy at the DOS prompt
  34. while one was performing board maintenance.  You will need 3 config files
  35. (see samples included) for complete operation of GAPLOCK.  Mine are named
  36.  
  37.    LOCK.CFG
  38.    CHECK.CFG
  39.    UNLOCK.CFG
  40.  
  41. You may name them any valid DOS name.
  42. I keep a copy of all config files in each nodes directory.  GAPLOCK.EXE is in
  43. a pathed directory.  Actually, the nodes checking for a LOCK condition only
  44. need CHECK.CFG
  45.  
  46. GAPLOCK LOCK.CFG will create a data file (gaplock.dat) where you specify
  47. in the configfile for the other nodes to check for a lock condition during
  48. an event.
  49.  
  50. Command Line Parameter for GAPLOCK is:
  51.  
  52.     GAPLOCK ConfigFile
  53.  
  54. EXAMPLE ConfigFile :  GAPLOCK1.CFG  (The configfile can be named any valid
  55.                                      DOS Name)
  56. ---------------------------------------------------------------------------
  57. The Beckett BBS
  58. 0000
  59. lock
  60. f:\work
  61. 300
  62.  
  63. ---------------------------------------------------------------------------
  64.  
  65. Line 1 : Your BBS Name
  66. Line 2 : Registration Number
  67. Line 3 : Gaplock Function (Must be either LOCK, CHECK, or UNLOCK)
  68. Line 4 : Path where Data File (GAPLOCK.DAT) is to be Read/Written
  69. Line 5 : Delay before beginning a check for a Lock condition.
  70.  
  71. ---------------------------------------------------------------------------
  72.  
  73.   This is the way that I use GAPLOCK.  On the node that will be doing the
  74.   actual maintenance, the following is used in a ConfigFile named LOCK.CFG.
  75.  
  76.   GAPLOCK lock.cfg is the first item executed in the event batch file.
  77.  
  78.   Contents of lock.cfg
  79. ----------------------
  80.   The Beckett BBS
  81.   0000
  82.   lock
  83.   f:\work
  84.   300
  85. -----------------------
  86.  
  87. This will create the GAPLOCK.DAT file on f:\work, and it will contain
  88. the word LOCK.
  89.  
  90. The last line in the EVENT.BAT file should contain the following.
  91.  
  92.   GAPLOCK unlock.cfg
  93.  
  94.   Contents of unlock.cfg
  95.  
  96.   The Beckett BBS
  97.   0000
  98.   unlock
  99.   f:\work
  100.   300
  101.  
  102. This will remove the LOCK condition in GAPLOCK.DAT indicating to the other
  103. nodes that the event is finished.
  104.  
  105. -------------------------------------------------------------------------
  106.  
  107. In each of my other nodes's EVENT.BAT files I have the following as the
  108. only command for that that event batch file.
  109.  
  110.   GAPLOCK check.cfg
  111.  
  112.   Contents of CHECK.CFG
  113. -----------------------
  114.   The Beckett BBS
  115.   0000
  116.   check
  117.   f:\work
  118.   300
  119. -----------------------
  120.  
  121. When this event is executed, GAPLOCK waits for 5 minutes (just incase
  122. the node performing maintenance didn't get started on time.  After 5 minutes
  123. GAPLOCK will begin checking f:\work\gaplock.dat for a LOCK condition.
  124.  
  125. GAPLOCK will continue checking GAPLOCK.DAT every 5 seconds until the LOCK
  126. condition is removed by the node performing maintenance.
  127.  
  128. Files needed for GAPLOCK Operation
  129.  
  130.   The only file needed for GAPLOCK to operate is GAPLOCK.EXE & 3 config files
  131.   It creates it's own data file.
  132.  
  133.  
  134. One other note:
  135.  
  136.     The Delay screen can be aborted by pressing Any Key.
  137.     GAPLOCK can be aborted by pressing the ESC Key
  138.  
  139.     GAPLOCK can be tested from the command line, if you want to see
  140.     how it works...  
  141.  
  142.     If you will be using one copy of GAPLOCK.EXE be sure to make the 
  143.     file Read Only...
  144. ──────────────────────────────────────────────────────────────────────────
  145. If you have any doubt about the integrity of the files contained in this
  146. Archive, feel free to call my BBS in Swedesboro, New Jersey and download
  147. the latest version.  The Beckett BBS, (609)467-3898/8612/0515
  148.  
  149. Registration - Support the Shareware Concept...
  150. ──────────────────────────────────────────────────────────────────────────
  151. GAPPLOCK is not crippled.  However, it can be annoying if not registered.
  152. It will beep every 5 seconds while checking for a LOCK condition.
  153. If you find it useful, Please register GAPLOCK.
  154.  
  155. Registration is $15.00
  156. Complete and mail the enclosed registration with check or money order
  157. to the address mentiond at the beginning of this file.  If you desire, you
  158. may register online using Visa or Mastercard.
  159.  
  160. Thanks for your support!
  161.